


RCSCLEAN(1)              USER COMMANDS                RCSCLEAN(1)



NAME
     rcsclean - clean up working files

SYNOPSIS
     rcsclean [_o_p_t_i_o_n_s] [ _f_i_l_e ... ]

DESCRIPTION
     rcsclean removes working files that  were  checked  out  and
     never  modified.  For each _f_i_l_e given, rcsclean compares the
     working file and a revision in the corresponding  RCS  file.
     If  it  finds  a difference, it does nothing.  Otherwise, it
     first unlocks the revision if the -u option  is  given,  and
     then  removes  the  working  file unless the working file is
     writable and the revision is locked.  It logs its actions by
     outputting  the  corresponding  rcs -u and rm -f commands on
     the standard output.

     If no _f_i_l_e is given, all working files in the current direc-
     tory  are  cleaned.  Pathnames matching an RCS suffix denote
     RCS files; all  others  denote  working  files.   Names  are
     paired as explained in ci(1).

     The number of the revision to which the working file is com-
     pared  may  be attached to any of the options -n, -q, -r, or
     -u.  If no revision number is  specified,  then  if  the  -u
     option  is  given  and  the  caller has one revision locked,
     rcsclean uses that revision;  otherwise  rcsclean  uses  the
     latest revision on the default branch, normally the root.

     rcsclean is useful for clean targets in Makefiles.  See also
     rcsdiff(1),  which  prints  out  the differences, and ci(1),
     which normally asks whether to check in a file if it was not
     changed.

OPTIONS
     -k_s_u_b_s_t
          Use _s_u_b_s_t style keyword  substitution  when  retrieving
          the revision for comparison.  See co(1) for details.

     -n[_r_e_v]
          Do not actually remove any files or  unlock  any  revi-
          sions.   Using  this option will tell you what rcsclean
          would do without actually doing it.

     -q[_r_e_v]
          Do not log the actions taken on standard output.

     -r[_r_e_v]
          This option has no effect  other  than  specifying  the
          revision for comparison.

     -u[_r_e_v]



GNU                  Last change: 1991/11/03                    1






RCSCLEAN(1)              USER COMMANDS                RCSCLEAN(1)



          Unlock the revision if it is locked and  no  difference
          is found.

     -V_n  Emulate RCS version _n.  See co(1) for details.

     -x_s_u_f_f_i_x_e_s
          Use _s_u_f_f_i_x_e_s to characterize RCS files.  See ci(1)  for
          details.

EXAMPLES
          rcsclean  *.c  *.h

     removes all working files ending in .c or .h that  were  not
     changed since their checkout.

          rcsclean

     removes all working files in the current directory that were
     not changed since their checkout.

FILES
     rcsclean accesses files much as ci(1) does.

ENVIRONMENT
     RCSINIT
          options prepended to the argument  list,  separated  by
          spaces.   A  backslash escapes spaces within an option.
          The RCSINIT options are prepended to the argument lists
          of  most  RCS commands.  Useful RCSINIT options include
          -q, -V, and -x.

DIAGNOSTICS
     The exit status is zero if and only if all  operations  were
     successful.    Missing  working  files  and  RCS  files  are
     silently ignored.

IDENTIFICATION
     Author: Walter F. Tichy.
     Revision Number: 1.8; Release Date: 1991/11/03.
     Copyright 8c9 1982, 1988, 1989 by Walter F. Tichy.
     Copyright 8c9 1990, 1991 by Paul Eggert.

SEE ALSO
     ci(1), co(1),  ident(1),  rcs(1),  rcsdiff(1),  rcsintro(1),
     rcsmerge(1), rlog(1), rcsfile(5)
     Walter  F.  Tichy,  RCS--A  System  for   Version   Control,
     _S_o_f_t_w_a_r_e--_P_r_a_c_t_i_c_e & _E_x_p_e_r_i_e_n_c_e 15, 7 (July 1985), 637-654.

BUGS
     At least one _f_i_l_e must be given in older Unix versions  that
     do not provide the needed directory scanning operations.




GNU                  Last change: 1991/11/03                    2



